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CUI/Dial-In Interface Design Report 


1.0 Introduction 

The purpose of this report is to provide insight into the approach and design of the 
Cooperative User Interface (CUI). The CUI is being developed based on HyperCard 
technology and will provide the same look and feel as is provided by NASA Electronic 
Library System (NELS) X-Window interface. The interaction between the user and 
ASCII-LIB is presented as well as the set of HyperCard Cards which the user will work 
with. 
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2.0 The AdaNET Cooperative User Interface (CUI) Design 

The AdaNET cooperative user interface (CUI) design consists of: 

a) a prototype HyperCard stack incorporating a set of screens (cards) for review and 
serving as a basis for defining the interface behavior, 

b) a description of the CUI behavior, and 

c) a preliminary recommendation for an ASCII-Lib command line interface 

The provision of a cooperative user interface for dial-in users is an important part of 
AdaNET service for users with desktop personal computers. The cooperative user 
interface will provide a graphical user interface (GUI) which simplifies AdaNET interaction 
yet requires only a low-bandwidth communication link (1200 baud modem) and simplified 
command-line interpreter on the host system. Without the cooperative user interface, dial- 
in users (the majority of current AdaNET users) would have available only the command- 
line interface. 

The design effort quickly focused on the use of HyperCard for the Macintosh and Toolbook 
for the IBM PC and compatibles with Microsoft Windows. The decision was based on 
cost and schedule constraints, the technical merits of utilizing a rapid prototyping 
environment and the desire to port the development solution to both the Macintosh and CBM 
PC systems. An initial investigation of Microphone (a telecommunication package 
available on both systems) proved unacceptable because of the high end-user cost. Both 
HyperCard and Toolbook allow for the distribution of the developed CUI at no cost to the 
end-user. A separate utility called Convert-It is available to aid in the porting of a 
HyperCard system to Toolbook. Since the utility exists for conversion in this direction 
only, and also because of our familiarity with HyperCard, the initial development will be in 
HyperCard. 

The basis for layout and interaction in the CUI is defined by the NELS X-Window 
implementation. This implementation provides an easily duplicated user interface and is 
the primary definition of NELS functionality. The "back-end" of the CUI is the command- 
line driver to the host. NELS will provide a command-line interface here referred to as 
"ASCII-Lib". Our design efforts have determined that within the restrictions of the 
HyperCard system (as compared to X-Windows) a nearly one-to-one matching of cards to 
windows is possible. (HyperCard is based on the layout of interactive fields on "cards". 
These may be considered the similar to interface screens, windows or window-panes 
defined in other interactive systems). This is based on the ability of HyperCard to model 
the X-Windows system and on the fact that ASCII-Lib is anticipated to be very closely 
derived from the X-Windows system. This latter consideration allows for a relatively 
simple translation of user interactions with cards to ASCII-Lib commands. 

The design centers around the definition of four classes of interface cards: "List 
Browsers", "Forms", "Query Generators", and "Displays". These four classes 
correspond to the four styles of interaction provided for. List Browsers allow the user to 
scroll through lists, highlight one or more items as a selection and initiate activity from 
menu commands. Forms consist of a list of fields, with the distinction that selecting the 
field brings up a panel for the user to change the contents of the field. Queries are similar 
to forms but include the interaction with ASCII-Lib in the development and eventual 
submittal of a user-defined search query. Displays are cards or panels brought up for 
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display only, with no interaction other than to have them put away when the user has read 
the information. It is clearly our recommendation that the design be implemented in 
HyperCard, then ported to Toolbook. While this does not serve all AdaNET users, it will 
address a reasonable number of users, and the two implementations will be available to 
serve as a basis for extending the CUI to other users as funding permits. 

Attached are three sets of pages providing details to this design. First is a more detailed 
discussion of CUI cards behavior. This establishes the functionality of programming 
scripts which implement the behavior for each card. The second attachment is an early 
proposal for an ASCII-Lib command language. This was developed in an assessment of 
feasibility for translation of user interaction to ASCII-Lib commands. We assume that 
ASCII-Lib will be similar to what we propose here as the basis of our confidence in being 
able to complete the job. The last attachment is the set of prototype HyperCard Cards for 
review. These cards are a preliminary definition showing how the X-Window interface 
will map to HyperCard. It is expected that all of these early definitions will change as 
NELS is revised and ASCII-Lib defined. 
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3.0 The Bridge Between User Actions and ASCII-Lib Interaction 

The CUI interface is based on "cards" which display certain information and embody a 
specific mechanism for interaction. 

The common paradigm for interaction is one of possible selection or input by the user, a 
menu item selection to initiate interaction with ASCII-Lib, a possible switch of active card, 
followed by display of ASCII-Lib responses. Each card will have a general display field in 
which all output from ASCII-Lib is displayed. The capture of output from ASCII-Lib will 
move from active card to active card as different cards are selected. It is intended that 
output thus captured will be specifically relevant to the card in which it is displayed. 

Just as in a simple terminal interface, at any point in time the user will see any characters 
being sent to and from ASCII-Lib (including noise on the line). It will appear quite 
different to the user however, since the display field will shift from one card to another. 
When activity shifts from one card to another, the previous relevant information from 
ASCII-Lib will remain. It is important that only an echo of ASCII-Lib commands and 
information in response is sent in non-verbose mode, without excessive prompting or 
menu display of commands available. 

It is our expectation that ASCII-Lib commands will correspond nearly one-for-one with 
menu items in the X-Windows version of NELS 1.2. 

Card Classes: 
list browsers 
query generators 
forms 
displays 


3.1 List Browsers: 

In a list browser a list of items for selection has been sent by ASCII-Lib and captured 
by the CUI in a list browser card. Interaction will consist of selecting an item from the 
list and selecting a menu command. The response will be to extract from the selected 
line the number of the item selected (always the first word on the line) and include that 
in the ASCII-Lib command to be sent. Selecting a list item and initiating a command 
generally implies shifting command modes, so the CUI will correspondingly activate a 
different and appropriate card for displaying the information requested. 


3.2 Forms: 

In a form, a list of fields and their current values will be sent by ASCII-Lib and 
captured by the CUI in a form card. Forms will behave initially just like lists: the user 
will select one line and initiate processing to inspect further or change the value. Again 
the number of the field will be sent to ASCII-Lib to indicate desired processing. 
However, in form processing a pop-up field will allow for the modification of the 
desired item and insertion of the new value in the previously displayed list. The pop-up 
field will extend the interaction of the user with ASCII-Lib to allow for display of a list 
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of allowable values sent from ASCII-Lib with selection by the user, or to allow for the 
user to type in the desired new value and have this sent to ASCII-Lib. 

Note that the CUI can handle updating the local display of the form, but that a refresh 
form command is necessary to allow the user to verify that the updates have been sent 
and received correctly by ASCII-Lib. 


3.3 Queries 

Queries can be handled very similarly to forms, the differences being in the display of 
the query being built and menu items to initiate the search. Each query card will be 
unique to the type of query being built. Building the query, for example the boolean 
query, will require the sending of a list of possible extensions for the user to select 
from, with corresponding selection by the user and pop-up fields for further 
interaction. Again, a display query command is necessary to allow the user to verify 
the query being generated. 
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Appendix A - ASV3 Command Line Interface to "ASCII-Lib" vl.2 

Note: To support CUI access, both mute mode (non-verbose) and command catenation are 
valuable. 

Command catenation means multiple commands strung together on one line. 

Main Menu: (default super-collection shown) 

List [<start> [<end>]] — list collections, where <start> and <end> are index 

integers 

description <index> -- show collection description 

Subjects <index> -- browse objects from collection 

glasses <index> - browse classes from collection 

S_earch ... — natural language, pattern match, boolean 

yjew ... — by index, by alpha, show nested, show related 

previous level 
Lop level 

n_ext level <index> 

jLrofile ... -- user customization 

application ... — mail, accounts 

S_xit, £2} help 
,v: View Menu 

hierarchy — son collection list by Collection ID (no subcollections shown) 

outline — sort collection list by Collection ID - show subcollections inline 

2 _lphabet — sort collection list by alphabet (no subcollections or related items 

shown) 

rej_ated -- sort collection list by Collection ID - show related items inline 

S_xit, (x) return. £21 help 

.01 Profile Menu 

(ol c ollection ... — prompt for default collection to view 

v_iew ... - set default view option (leads to above), 

(t) strategy ... — set search strategy option (c. s. r) 

directory ... - prompt for directory path name for local copies 

(r) script ... -- prompt for path name to script for copy 

j 2 _rint ... -- prompt for path name to script for print 

m ax list size ... -- prompt for max list size 

(ui cutoff ... - prompt for cutoff ?! 

£n)_save profile 
List settings 

£_xit, (xl return. £21 help 


SOF TecH 


A-l 



.21 Object Browser 

List [<start> [<end>]] 
description <index> 
meta-data <index> 

Subject <index> 

Lile request <index> 

natural language 
comparable <index> 
object <index> 

exit, (x) return. (?) help 


-- display current object list 

— show object description (abstract) 

-- show object meta-data 

— show object itself 

— output request (copy, download, media support) 

— refine browse list through natural language search 

— revise browse list to include objects comparable to 


list classes, where <start> and <end> are index 
integers 

show meta-data for class <index> 
enter object browser for class <index> 

exit, £x} return, £21 help 

•11 Applications 

? 


.c; Class_Browser 

List [<start> [<end>]] 

m eta-data <index> 
SLbjects <index> 


...a_ll or sjngle 
...prompt for user_id 
...prompt for retain until date 
...prompt for message 


.. v: ? View (messages) 

delete 
(ri) v iew 

exit, £>cl return, (?) help 

•SI Search 

natural language 
boolean index 
Lndex 

exit, (x) return. (?) help 


.. n: ? Notify (send message) 
n.otify mode 
IP (user_id) 
retain 
m essage 
S_end 

exit, £ 2(1 return, £21 help 


-HI Natural Language Search 

Lnput query 
S_tart 

v_iew query 
Clear query 
sxrategy 


SOF[ ecH 


A-2 



..b; 


Boolean Search on Fields 


Lirst field 
3 _nd 

B_ot 
U_ndo 
fk) clear 
Y_iew query 


— ... select index field and match desired 

— ... select index field and match desired 

— ... select index field and match desired 

— ... select index field and match desired 


sxrategy 

S_tart 

S_xit, £xl return, £2} help 


. f. a. o. n: Field Selection 


1 - <undefined> 

2- 

Object Name 

3 - Format 

4- 

Class Id 

5 - Address 

6- 

Version 

7 - Library Entry Date 

8- 

Title 

9 - Author 

10- 

Subject Terms 


..ll Index Search on Fields 

f. u. k. v. s. t — as for Boolean Search on Fields 
S_xit, (x) return. £2} help 


Dots (.) preceding letters indicate the number of menu levels there are above this prompt. 
Trailing ellipses (...) indicate linkage to sub menus. 
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Appendix B - HyperCard Cards 





File Search Browse Uiew Application Help 










File Edit/Search Uieiu Help 






File Uiew Browse Help 
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File Edit/Search Uiew Help 





